home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / tools / monitors / restracker / rtfreeresources.doc < prev    next >
Text File  |  1996-07-16  |  3KB  |  70 lines
  1. rtFreeResources.doc
  2.  
  3. NAME
  4.      rtFreeResources - free resources tracked by rt
  5.  
  6. VERSION
  7.      V0.9b - 12-07-96
  8.  
  9. SYNOPSIS
  10.      rtFreeResources TCB/A,Debug/S,Ask/S,Show/S
  11.  
  12. REQUIREMENTS
  13.      - AmigaOS 3.0 (V39) or higher
  14.      - the "rt" resource tracker must be run first
  15.  
  16. OPTIONS
  17.      TCB/A     : The address of a task-control-block in hex, just as
  18.                  printed by various "ps"-clones. This argument is required!
  19.      Debug/S   : Print lots of text while stepping through rt's lists
  20.      Ask/S     : Pop up a requester before freeing any resource, asking you
  21.                  to confirm or cancel the action.
  22.      Show/S    : Don't free anything, just show all resources currently in
  23.                  use by the specified task.
  24.  
  25. DESCRIPTION
  26.      rtFreeResources is a utility for the "rt" resource-tracking system. It
  27.      scans rt's resource lists for resources allocated by a given task and
  28.      frees them. Not much to say about it, see OPTIONS and EXAMPLE for more
  29.      info.
  30.  
  31. EXAMPLE
  32.      Let's assume a task called "foo" left a window and a file open and
  33.      crashed. What you have to do is first to find its TCB address. A tool
  34.      like Executive's "ps" (or the one included with muFS) is fine for
  35.      that. Then call rtFreeResources with the TCB address as a parameter,
  36.      plus optionally the Ask or Debug switch. If you didn't ask for a
  37.      confirmation requester (Ask/S), rtFreeResources will just free all
  38.      resources allocated by "foo" and tell you that it did. Specifying
  39.      "Debug" will make it tell you more than you probably want to know :-)
  40.      For safety, always tell it to Ask/S you before freeing anything, so
  41.      you don't kill your own shell windows or filehandles or sorta that.
  42.  
  43. BUGS
  44.      If the specified task has died, mainly two problems can occur:
  45.        - If the TCB has already been freed and overwritten, the task name can
  46.          not be retrieved and will be printed as garbage. Not much I can do
  47.          about this...any ideas?
  48.        - if the resource itself has vanished (most likely caused by some
  49.          other tool kicking it "the hard way"), rtFreeResources may crash
  50.          while trying to close the resource. Seems like something you gotta
  51.          live with, I can't see many possibilities for sanity checks here
  52.          either.
  53.      - Sometimes debug output looks bogus.
  54.  
  55. HISTORY
  56.      V0.9b  (12-07-96): First Release
  57.  
  58. TODO
  59.      - sanity checks?
  60.      - improve list arbitration while stepping through the resource lists
  61.  
  62. AUTHOR
  63.      Matthias Bethke
  64.      Giessener Strasse 31
  65.      35457 Lollar
  66.      Germany
  67.      AmigaNet: Matthias Bethke@39:176/208.0
  68.        Usenet: postmaster@sweetdreams.lahn.de
  69.            or: Matthias.Bethke@sowi.uni-giessen.de
  70.